home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / term / vltj5867.lha / Installation next >
Text File  |  1994-04-20  |  8KB  |  219 lines
  1.  
  2. This is a short file describing the installation of VLT.
  3.  
  4. Other files you may want
  5. ------------------------
  6.  
  7. VLT uses certain other files that are not distributed with VLT. None
  8. of these are absolutely required, but some features are not available
  9. if they are not there.
  10.  
  11. 1. VLT will complain if it cannot find the external file transfer
  12.    protocol library (XPR) that is currently selected. While it seems
  13.    that XMODEM and Kermit are built in, they really are not. Despite
  14.    the complaint, VLT will run fine anyway (but can't transfer files).
  15.    It would be good to acquire the freely distributable XPR libraries
  16.    of your choice. Currently, there exist ones for XMODEM, Kermit,
  17.    ZMODEM, Jmodem, CompuServe Quick-B, and YMODEM. An ASCII XPR
  18.    is included (xprascii.library).
  19.  
  20. 2. The VLT "online docs" are in AmigaGuide. If you do not have
  21.    AmigaGuide.library, you should install it on your system.
  22.  
  23. 3. Some of the ARexx programs that come with VLT require that you
  24.    have rexxarplib.library version *3.0* or later. Earlier versions
  25.    of rexxarplib.library will not work correctly. Rexxarplib.library
  26.    is available on BIX and on the anonymous FTP site
  27.    ftp.slac.stanford.edu, as well as various online services
  28.    and BBS's.
  29.  
  30. 4. If you intend to play with FifoBBS.rexx and similar Fifo: based
  31.    utilities, you must install the Fifo: handler by Matt Dillon.
  32.    Not needed for normal operation.
  33.  
  34. 5. There are lots of nice VLT scripts that you may be interested in,
  35.    written by others. Some implement phone books (see however also
  36.    the one included with this distribution), others, automated
  37.    up/download facilities for on-line services.
  38.  
  39.  
  40. Installation: First time users (but upgraders, read anyway!)
  41. ------------------------------------------------------------
  42.  
  43. If this is the first time you have downloaded VLT, then the installation
  44. is very simple.
  45.  
  46. 1. You have already extracted all files from this archive. You should
  47.    have done this using the command:
  48.  
  49.     lha -x -a x vltj5867.lha
  50.  
  51.    or
  52.  
  53.     lha -x -a x vlt5p867.lha
  54.  
  55.    depending on whether you obtained VLTjr or VLT.
  56.  
  57.    If you did not do it that way, please start over. It is important
  58.    to create all subdirectories, and also the -a part is necessary.
  59.  
  60. 2. Now that you have extracted all files, you should see, from the
  61.    Workbench, a drawer called VLT. Drag this drawer to the place where
  62.    you want VLT to live.
  63.  
  64.    If you want to install VLT on a floppy, consult the printed manual
  65.    (see vlt/docs/VLT.guide for how to obtain it). You will have to
  66.    delete a lot of files on a Workbench floppy to make room for VLT.
  67.  
  68. 3. You are now essentially done. (See however the section on other
  69.    files VLT needs, above). If you want to make VLT resident, see
  70.    also point 4.
  71.  
  72.    When you open the VLT drawer, you will see the VLT icon, and also a VLT
  73.    script icon. Double click on VLT to start it, or double click on the
  74.    VLT script icon to see how that goes.
  75.  
  76.    Next, note the "Help" item in the VLT main menu. It will open (if you
  77.    have AmigaGuide.library) the VLT on-line documentation.
  78.  
  79.    Note, that most files that come with this archive do not have icons.
  80.    If you select "show all files" you can browse around and see what else
  81.    there is. Of special interest is the docs drawer, which has the
  82.    previously mentioned VLT AmigaGuide documentation. This guide
  83.    assumes that you have the manual for the previous version of VLT,
  84.    which can be obtained free of charge from SLAC. See the guide for
  85.    details. Each subdirectory has a brief readme file explaining what
  86.    all the files in that subdirectory are for.
  87.  
  88. 4. If you intend to make VLT resident, then you must assign vlt: to the
  89.    directory that contains VLT. I.e., if you copied the VLT drawer to
  90.    your work: partition, then you must assign VLT: to work:VLT. Add the
  91.    line:
  92.  
  93.     assign VLT: work:VLT
  94.  
  95.    to your startup sequence.
  96.  
  97. 5. If you run from a shell a lot, you probably want to add a path to the
  98.    directory that VLT lives in. Add the line:
  99.  
  100.     path add work:VLT
  101.  
  102.    to your startup sequence, if that's where VLT's executable is.
  103.  
  104.  
  105. Upgrading from VLT version 5.576
  106. --------------------------------
  107.  
  108. If you are upgrading from VLT version 5.576, then the installation is
  109. also very easy. That is, if you installed VLT 5.576 in a directory all
  110. by itself, as recommended. If you did not, then skip to the section
  111. on upgrades from older versions of VLT. Again, for floppy installation,
  112. see the printed manual.
  113.  
  114. 1. Rename your current VLT drawer to "oldVLT"
  115.  
  116. 2. Execute step 1 above.
  117.  
  118. 3. Now that you have extracted all files, you should see, from the
  119.    Workbench, a drawer called VLT. Drag this drawer to the place where
  120.    your old VLT drawer used to live.
  121.  
  122.    If you changed any of the files that came with the previous version
  123.    of VLT, copy them from the oldVLT drawer to the corresponding place
  124.    in the VLT drawer. This likely includes the files VTPrefs.dat and
  125.    in the case of the full VLT, TekPrefs.dat in the s drawer.
  126.  
  127. 4. Now execute steps 3, 4 and 5 above as necessary.
  128.  
  129. 5. You can now delete the oldVLT drawer, unless you want to keep it for
  130.    a while as a backup.
  131.  
  132.  
  133. Upgrades to older versions of VLT
  134. ---------------------------------
  135.  
  136. If you're upgrading from an older version of VLT you have to make a
  137. decision first. You can either install VLT in a directory somewhere,
  138. with all the files it needs, or you can install VLT like you
  139. installed the previous versions. If you want to take the easy way
  140. out, just install it the way you installed it previously (i.e., devs
  141. files go to devs:, libs files to libs:, s files to s: etc.). Note
  142. that in that case you want to combine the scp files and rexx files
  143. all into rexx:. The docs files should go into the same drawer as the
  144. VLT executable.
  145.  
  146. Alternatively, you can take the opportunity to clean up your system
  147. some. In principle the installation then is similar to the way
  148. described above for new users, but you probably have lots of files of
  149. your own that you want to copy to subdirectories in the new VLT
  150. directory. But you have to be careful to not overwrite the new files
  151. that came with VLT with the old ones you already had - unless you
  152. made modifications and want to keep your own version.
  153.  
  154. Here's a possible installation sequence:
  155.  
  156. 1. Unpack the VLT archive as described above.
  157.  
  158. 2. Make a directory called, say, work:vltnew . Also make directories
  159.    work:vltnew/rexx and work:vltnew/scp .
  160.  
  161. 3.    copy rexx:*.vlt work:vltnew/rexx
  162.     copy rexx:*.scp work:vltnew/scp
  163.  
  164.    Also copy all other VLT-related rexx files to work:vltnew/rexx .
  165.  
  166. 4. From the Workbench, drag the VLT drawer that was created when you
  167.    unpacked the archive, to work:. You should now have a VLT and a
  168.    VLTnew drawer on work:.
  169.  
  170. 5. From the CLI, do:
  171.  
  172.     copy work:VLT work:VLTnew all
  173.  
  174. 6. Now delete work:VLT as follows:
  175.  
  176.         delete work:VLT all
  177.  
  178. 7. Now rename VLTnew to VLT:
  179.  
  180.     rename work:VLTnew work:VLT
  181.  
  182. 8. Now copy the configuration files:
  183.  
  184.     copy s:VTPrefs.dat work:VLT/s
  185.     copy s:TekPrefs.dat work:VLT/s
  186.  
  187.    If you made changes to s:TekProlog.ps, make the same changes again to
  188.    work:VLT/s/TekProlog.ps.
  189.    Delete these files from s:.
  190.  
  191. 9. Copy all the XPR libraries you have, if you wish, to work:VLT/libs .
  192.    Then delete these files from libs:.
  193.    If you have other programs that need access to the XPR libraries,
  194.    it is probably better to leave them in libs:
  195.    However, you can now delete from libs: the following libraries:
  196.    review.library, strokefont.library, duplexfont.library and
  197.    simplexfont.library.
  198.  
  199. 10. If you wish, you can now delete all VLT specific fonts from fonts: .
  200.     delete fonts:vlt* all
  201.  
  202. 11. If you intend to make VLT resident, make a VLT: assignment, as in
  203.     the "new user" case. If you run from a shell a lot, add the
  204.     directory VLT lives in to your path (see new user installation points
  205.     4 and 5).
  206.  
  207. 12. If you find that VLT in certain cases can't find certain files, read
  208.     the section about "path searches" in the manual carefully. You
  209.     can almost always make VLT: find files by making some more
  210.     assignments, or by consolidating files in certain directories, or
  211.     by eliminating directories you're not actually using that VLT finds
  212.     anyway. If you don't have the printed manual yet, this information
  213.     is also in the VLT5p576.doc file.
  214.  
  215. This completes the VLT installation.
  216.  
  217.     Willy Langeveld, April 1994.
  218.  
  219.